home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / zlplus10.arc / ZIPLAB.DOC < prev   
Text File  |  1991-09-21  |  14KB  |  284 lines
  1.                         
  2.                                ZipLab PLUS
  3.                                Version 1.0
  4.                   (C)Copyright 1991 by Jeffrey S. Morley
  5.                               July 6th, 1991
  6.  
  7.                  Archive test program for PCBoard/ProDoor
  8.                   
  9.                    
  10. ZipLab is a alternative/replacement for the PCBTEST.BAT/PROUTEST.BAT files 
  11. which are run by PCBoard/PRODOOR after a user uploads file(s).  In the past, 
  12. we have all run maybe PKUNZIP -T on each file, and if there were no CRC 
  13. erorrs, all was considered well.  There is a lot more we can do to protect 
  14. ourselves and our users from unwanted files!  ZipLab will do the following:
  15.  
  16. * Test for CRC errors in the archive file.
  17. * Test for imbedded archive files and if found, CRC check those too.
  18. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  19. * Virus SCAN archive member files, using SCAN.EXE from McAffey.
  20. * SCAN inside archive files imbeded inside another archive file.
  21. * Remove all archive comments from the file.
  22. * Replace archive comments with your own. (Optional)
  23. * Delete unwanted BBS ads and/or other unwanted archive members as you define.
  24. * Test .GIF files for validity if you accept that file format (Optional)
  25. * Reject programs older than a date (year) which you specify.
  26. * Adds most recent archive member date to the description (Optional)
  27. * Allow you to test outside of PCBoard/ProDoor, and use wildcards!
  28. * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
  29.  
  30. *******************************************************************************
  31.  
  32.   ** ZIPLAB IS NO LONGER "FREEWARE".  REGISTRATION IS REQUIRED FOR ITS USE **
  33.  
  34.     PLEASE SEE THE ENCLOSED REGISTER.DOC FILE FOR REGISTRATION INFORMATION
  35.  
  36.           
  37.  ******** A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE! *********
  38.                 DO A SEARCH FOR NEW! TO FIND IMPORTANT CHANGES
  39.  
  40. REQUIRED:
  41. You must already have the following programs:
  42.  
  43. PKZIP.EXE   - Phil Katz archive create program (version 1.01 +)
  44. PKUNZIP.EXE - Phil Katz archive extract program (version 1.01 +)
  45. LHARC.EXE   - Yoshi's archive program (version 2.12 +)
  46. ARJ.EXE     - Robert Jung's archive program (verison 2.10 +)
  47. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
  48. SCAN.EXE    - McAffey's virus detection program (any version)
  49.  
  50. There are other small utility programs which I have bundled with this .ZIP.
  51. They may require registration for continued use.  PLEASE SUPPORT SHAREWARE 
  52. AND DO SO!
  53.  
  54. RECOM.EXE   - Mike Loewen's ZIP file comment remover and date stamper.
  55. GIFTEST.EXE - Dave Navarro's .GIF file tester (part of GIFTSTxx.ZIP)
  56. DELF.COM    - A version of DEL with no "Are you sure?" prompt written by me.
  57.               (No registration required)
  58.  
  59.  
  60. Quick Start ---
  61.  
  62. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is 
  63.   limited memory available for PTEST.EXE.  If you are running in a 
  64.   multitasking or other memory constrained situation, PTEST may not work! 
  65.   You should have at least 210k free memory when shelled out of PCBoard.  If 
  66.   this is a problem, you may want to consider the VAROOM (overlay) version 
  67.   of PCBoard, which runs in considerably less memory than the standard 
  68.   PCB.EXE.
  69.   
  70.   The other option is to run PCBoard with the SET PCB = /SWAP environment
  71.   variable.  This will cause PCBoard to "swap" its code to the best available
  72.   storage (EMS, DISK) whenever a SHELL function (external protocol, viewfile,
  73.   and even DOORs if you have the SHELL column in DOORS.DAT(LST) set to "Y")
  74.   is called.  This method will cause a slight delay when SHELLing, but will
  75.   provide the largest amount of available DOS memory for your external code.
  76.   
  77. * Place the PTEST.EXE, SETUP.EXE and DELF.COM files into a directory which is
  78.   in your DOS PATH.
  79.  
  80. * UnZIP the enclosed supplemental utilities into directories in your DOS PATH.
  81.   Make note of where you put them, you will need this information later.
  82.  
  83. * Create, or use any existing directory to hold your PTEST configuration files.
  84.   Change into this directory, and run SETUP.EXE once for each of your nodes.
  85.   Be sure to give different configuration file names for each node.  I use
  86.   PTEST1.CFG and PTEST2.CFG. You may keep the particular node's configuration
  87.   file in the PCBoard ROOT/HOME directory for the node, but this is not 
  88.   required.  
  89.  
  90. * Fill in the following information when prompted by SETUP.EXE:
  91.  
  92.         -  The [drive:\path\]filename.ext of the .CFG file you wish created.
  93.            (This information will not be written to the .CFG file)
  94.         -  The type of modem HANDSHAKE you desire.  This can be 
  95.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  96.            (Use 2 or 3 with an error correcting modem...)
  97.         -  The DRIVE:\PATH\NAME of your PCBOARD.DAT file for this node.
  98.         -  The name of your BBS system.  43 characters maximum.
  99.         -  The DRIVE and PATH to the directory where rejects will be
  100.            placed pending manual sysop inspection.
  101.         -  The date (yyyy) which will be the minimum acepted year.  ZIPs
  102.            containing files older than this will be rejected.
  103.         -  A "Y" if you wish the "recent date" notation added to the file
  104.            descriptions.  A "N" if you do not wish this addition.
  105.         -  The fully qualified filename of the zip comment to add, or
  106.            type "NONE" if you don't want to add a comment.
  107.         -  Full DRIVE:\PATH to PKZIP.EXE.
  108.         -  Full DRIVE:\PATH to PKUNZIP.EXE.
  109. NEW!!   -  Full DRIVE:\PATH to LHARC.EXE.
  110. NEW!!   -  Full DRIVE:\PATH to ARJ.EXE.
  111.         -  Full DRIVE:\PATH to TDCHECK.EXE.
  112.         -  Full DRIVE:\PATH to SCAN.EXE.
  113.         -  Full DRIVE:\PATH to RECOM.EXE.
  114. NEW!!   -  Full DRIVE:\PATH to GIFTEST.EXE (Just lie to it if not using)   
  115.            NOTE!!! This was TESTGIF.EXE in previous versions, but is now
  116.            the more powerful GIFTEST.EXE from the same author.
  117. NEW!!   -  The DRIVE:\PATH\FILENAME of your GIFTEST.CFG file.
  118.            Just hit ENTER if you do not desire to test .GIF files.  
  119.         -  A list, each on one line, of any extensions (.EXE, .TXT etc)
  120.            Which will be passed without normal ZIP testing.  Any 
  121.            extensions other than .ZIP which do not appear in this .CFG
  122.            file will be rejected by the process.  The "." is optional.
  123. NEW!!      If .GIF appears in this list, GIFTEST will be used to test
  124.            the integrity of the .GIF file.
  125.         -  A list, each on one line, of files which you wish deleted
  126.            from .ZIP's before posting.  This could include the famous
  127.            "READMEOR.DIE", "BBS.AD", or other unwanted advertising.
  128. NEW!!      You may also have a file with these names listed one on each
  129.            line, and pass the name of the file with an "@" before the
  130.            name.
  131.  
  132.             Sample PTEST.CFG file:
  133.             
  134.             2           
  135.             C:\NODE1\PCBOARD.DAT
  136.             The Interconnect BBS
  137.             M:\HOLD
  138.             1990
  139.             Y
  140.             C:\EXE\COMMENT.CMT
  141.             C:\ZIP\PKZIP.EXE
  142.             C:\ZIP\PKUNZIP.EXE
  143. NEW!!       C:\ZIP\LHARC.EXE
  144. NEW!!       C:\ZIP\ARJ.EXE
  145.             C:\ZIP\TDCHECK.EXE
  146.             C:\DIAGS\SCAN.EXE
  147.             C:\EXE\RECOM.EXE
  148. NEW!!       C:\EXE\GIFTEST.EXE
  149. NEW!!       C:\EXE\GIFTEST.CFG
  150.             .ROM
  151.             .GIF
  152. NEW!!       @BBSADS.LST
  153.  
  154. * Edit your existing PCBTEST.BAT file, and delete the whole thing except
  155.   for two lines:
  156.   
  157.   Sample PCBTEST.BAT file:
  158.   
  159.   @ECHO OFF
  160.   PTEST %1 C:\ZIPLAB\PTEST1.CFG
  161.  
  162.    
  163. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass 
  164.   command over to PTEST.EXE with the parameter containing the path
  165.   and name of the file to be tested.  PTEST will check out the file,
  166.   placing any rejects in the holding directory you specified in the
  167.   SETUP process above.  
  168.  
  169.   
  170. *  PRODOOR SYSOPS -
  171.    You will need to set up your PROUTEST.BAT file like this:
  172.                 
  173.    echo off
  174.    rem -- process test uploads request - for ProDOOR 3.4
  175.    rem -- %1-logfile, %2-testdir, %3-comport
  176.    
  177.    rem -- test each uploaded file individually
  178.    proecho %3 ~~Testing uploads.  Please wait...~
  179.    
  180.    SET PCBDOOR=PRODOOR
  181.    for %%f in (%2\*.*) do COMMAND /c PTEST %%f drive:\directory\configfilename
  182.    SET PCBDOOR=
  183.    
  184.    :end
  185.                 Replace the "drive:\..." stuff with the location and name
  186.                 of the PTEST configuration file for this node.
  187.  
  188.                 Be sure you have enough ENVIRONMENT space to set up the 
  189.                 PCBDOOR variable.  If you are using DesqView, you may
  190.                 want to set PCBDOOR=xxxxxxx in your AUTOEXEC.BAT to be
  191.                 sure enough room is allocated in your DesqView partions
  192.                 for this variable.  The x's will be replaced by PRODOOR
  193.                 when PROUTEST.BAT is executed.  I need this variable set
  194.                 to "PRODOOR", or PTEST won't know you are running out of
  195.                 ProDoor.  You don't want to leave it set to PRODOOR though,
  196.                 since this could confuse things for other doors/processes.
  197.                 Thus the "SET PCBDOOR=" line.  ZipLab will fully work
  198.                 with ProDoor, including display/modification of the file
  199.                 descriptions.
  200.   
  201. * NEW!! IN THIS VERSION *******************************************************
  202.  
  203. ZipLab PLUS   - A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE!
  204.                 
  205.                 This is the new ZipLab PLUS!  A lot of hard work has gone 
  206.                 into this and earlier versions, and I will be requiring a
  207.                 registration fee with this version.  See REGISTER.DOC for
  208.                 details on how to register ZipLab PLUS.
  209.                 
  210.                 ZipLab will now test .ARJ and .LZH files, as well as the
  211.                 .ZIP format.  You will need to have ARJ.EXE and LHARC.EXE
  212.                 if you accept these formats, and a change to the .CFG file
  213.                 is required to tell PTEST where they are.  You must put
  214.                 them in the .CFG file, even if you don't accept these
  215.                 formats, and don't have the programs... Just lie to it.
  216.                 
  217.                 ZipLab now fully supports ProDoor as well as PCBoard.
  218.  
  219.                 You may now run ZipLab while out of the bulletin board
  220.                 system, and may use wildcards (* or ?).  This will allow
  221.                 you to test existing archive files on your system.  No
  222.                 changes will be made to existing descriptions.  To enable
  223.                 this feature, place the word LOCAL at the end of the PTEST 
  224.                 command line.
  225.                  
  226.                 example: C:\ZIPLAB>PTEST m:\pcb\dir1\*.zip ptest.cfg LOCAL
  227.                 
  228.                 
  229.                 ZipLab will now SCAN archives inside archives to test for
  230.                 virus infestation.
  231.                 
  232.                 You may now have rejected uploads left in your private 
  233.                 directory if you so desire.  Set the "holding" directory to 
  234.                 the location of your "private" or "upload" directory (as you 
  235.                 wish), and the files will remain there.  The descriptions 
  236.                 will be posted to your "private" dir.  This corrects a 
  237.                 situation where sysops trying to do this with earlier 
  238.                 releases of ZipLab would lose the rejected file.
  239.                 
  240.                 The ORIGINAL file date of the archive file is now retained.
  241.                 Earlier versions of ZipLab would set the archive file date
  242.                 to the date of the newest member in the archive.  This was
  243.                 required for age testing, but is no longer.
  244.                 
  245.                 ZipLab will NOT leave behind "hidden, read-only or system" 
  246.                 files which were imbedded in archives.  They will be tested,
  247.                 and properly deleted when the testing is finished.
  248.                 
  249.                 ZipLab now uses GIFTEST.EXE to test .GIF files (if you 
  250.                 permit them).  This program (by Dave Navarro) will allow
  251.                 you to set up a GIFTEST.CFG file - giving you even more
  252.                 control over .GIF testing.  An addition to your PTEST.CFG
  253.                 file is required to support this.  Please read the docs
  254.                 with GIFTSTxx.ZIP for details on how to best set up the
  255.                 GIFTEST.CFG file.  YOU MUST REGISTER GIFTEST TO USE IT!
  256.                 
  257.                 You may now put all BBS advertising file names into a text
  258.                 file, one on each line.  In PTEST.CFG, place an "@" before
  259.                 the name of this text file, and ZipLab will delete all
  260.                 listed advertising files in one pass.  THIS IS MUCH FASTER
  261.                 for those with multiple advertising files to reject.
  262.                 
  263.                 
  264. ***********************************************************************************************
  265.  
  266.   
  267.    This program was written in QuickBasic 4.5, with some help from Hammerly 
  268.   Computing's ProBas 4.01.  I have also included a few utilities which PTEST 
  269.   will use in the course of testing.  These utilities are the property of the 
  270.   authors, and you are strongly requested to register them if you continue to 
  271.                               use ZIPLAB PLUS.  
  272.  
  273.  
  274.  
  275.                              Jeffrey S. Morley
  276.                            The Interconnect BBS
  277.                                (703)425-2505
  278.  
  279.             PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
  280.  
  281.                 (C)Copyright 1989-1991 by Jeffrey S. Morley
  282.   
  283.  
  284.